home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / asystat < prev    next >
Encoding:
Text File  |  1995-09-17  |  2.9 KB  |  55 lines
  1.  
  2. asystat
  3.  
  4.      Display statistics on attached asynchronous communications
  5. interfaces (8250 or 16550A), if any.  The display for each port
  6. consists of three lines.  The first line gives the port label and the
  7. configuration flags; these indicate whether the port is a 16550A chip,
  8. the trigger character if any, whether CTS flow control is enabled,
  9. whether  RLSD (carrier detect) line control is enabled, the speed
  10. in bits per second, and the port address and IRQ number in hexadecimal.
  11. (Receiving the trigger character causes the driver to signal upper
  12. layer software that data is ready; it is automatically set to the
  13. appropriate frame end character for SLIP, PPPand NRS lines.)
  14.  
  15.      The second line of the status display shows receiver (RX) event
  16. counts:  the total number of receive interrupts, received characters,
  17. receiver overruns (lost characters) and the  receiver  high water
  18. mark.  The high water mark is the maximum number of characters ever
  19. read from the device during a single interrupt.  This is useful  for
  20. monitoring system  interrupt  latency margins as it shows how close
  21. the port hardware has come to overflowing due to the inability of the
  22. CPU to respond to a receiver interrupt in time. 8250 chips have no
  23. FIFO, so the high water mark  cannot  go higher  than  2  before
  24. overruns occur. The 16550A chip, however, has a 16-byte receive FIFO
  25. which the software programs to interrupt  the CPU when the FIFO is
  26. one-quarter full.  The high water mark should typically be 4 or 5 when
  27. a 16550A is used; higher values indicate that the CPU has at least
  28. once been slow to respond to a receiver interrupt.
  29.  
  30.      When the 16550A is used, a count of FIFO timeouts is also
  31. displayed  on the RX status line.  These are generated automatically
  32. by the 16550A when three character intervals go by with more than  0
  33. but  less than 4 characters in the FIFO.  Since the characters that
  34. make up a SLIP or NRS frame are normally sent at full line speed, this
  35. count will usually be a lower bound on the number of frames received
  36. on the port, as only the last  fragment of a frame generally results
  37. in a timeout (and then only when the frame is not a multiple of 4
  38. bytes long.)
  39.  
  40.      Finally, the software fifo overruns and high water mark  are
  41. displayed.  These indicate whether the <bufsize> parameter on the
  42. attach command needs to be  adjusted  (see  the  Attach  Commands
  43. chapter).
  44.  
  45. The third line shows transmit (TX) statistics, including a  total
  46. count of transmit interrupts, transmitted characters, the length of
  47. the transmit queue in bytes, the number of status  interrupts, and
  48. the number of THRE timeouts. The status interrupt count will be zero
  49. unless CTS flow control or RLSD  line  control  has  been enabled.
  50. The  THRE  timeout  is  a stopgap measure to catch lost transmit
  51. interrupts, which seem to happen when there is a lot  of
  52. activity (ideally, this will be zero).
  53.  
  54.  
  55.